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APPENDIX A 



•.ypl aysr?rame . ] ava 



-le. DMXPlayor 
.ihor bchemcl 

:scri;,;ic r This app 1 1 '/n reads rid W) fr^m a text file and writes it to a DMX channel. 



import java.awt.*; 
import java .awt .event . * ; 
■import j'avax . swi ng . * ; 
import java.util , * ; 
import java.io.*; 

import com . colorki neti cs . control .dmx . * ; 

public class DMXPlayerFrame extends JFrame * 
I 

// important ; Source code between blgin/END comment pair will be regenerated 
// every time the form is saved. All manual changes will be overwritten. 

// BEGIN GENERATED CODE 

// member declarations 

javax. swing.:) But ton loadFH eButton - new javax . swing. jeuttonO ; 
javax. swing. JLabel f i 1 eNameStati c • new javax . swi ng . JLabel O ; 
javax ♦ swing. 3Label numEntri esStati c ■» new javax , swing. 3Label () ; 
javax, swing, 3Label minStatic •» new javax . swi ng . DiabelO ; 
javax . swing . 3Label maximumStati c - new javax . swi ng . Jiabel () ; 
javax. swing. Jtabel delayStatic - new javax . swing . JLabel C) ; 
javax. swing. Uabel f i leNameLabel - new javax. swing. JLabel O ; 
javax .swing, 3 Label numEntri estabel - new j avax , swing, jLabeH) I 
javax, swing. 3 Label minLabel » new ^avax. swing, JLabel () ; 
javax , swing . OLabel maxtabel - new javax . swi ng . Siabel Q ; 
javax. swing. button startButton - new javax .swing . 3Button() ; 
javax. swing. DButton stopOutton * new javax . swing. JButtonO ; 
javax. swing. Jautton exitButton - new javax . swi ng . 3Button() ; 
javax. swing. JButton initButton » new javax , swing. JSuttonO ; 

// END GENERATED COOE 

Integerlnput delaylnput - new integerlnput(100 t 6,0, 1000000); 

LinkedList dataList - new Li nkedLi stO ; 
int datacount » 0; 
oouble dataMax - new Double(O.O): 
Double dataMin « new oouble(O.O); 

Runnable pi ayerThread ; 
Thread th; 

private DMXUm verse dmx; 
private String[] interNames; 
private int sel ectedlnterf ace = -1; 

public OMXPlayerFrame<) 
{ 

dmx - new DMXum verse("DMXPlayer") ; 

} 

public void initComponents 0 throws exception 

// important: source code between begin/end comment pair will be regenerated 
// every time the form is saved. All manual changes will be overwritten. 

// BEGIN GENERATED CODE 

// the following code sets the frame's initial state 
ToadFileButton.setSize(new java . awt . Di mens ion(U0 , 30)); 
loadFi 1 eButton. setvi si ble( true) ; 
loadFi 1 eButton. setText( "Load Fi le. . . ") . 

loadFileS'j'to-i.setLocatio^Cnew java .awt .Point (1IC, 70)); 

fileNanieS-s'.-c.setSizeCnew java. aw: oirrensicn(i2C , 20)); 

f i leNameS'-at c setvi si ble(t ruo) ; 

f lleN.imeb .-v . s*» ti i»xi (*'» -. namr . ' ) ; 

f i leNameS .at i c . setLocat ion (new java . awt . t'oi nt ( JO, 150) ) , 
numEntri esStati c . setSi ze(new java . awt .Dimension(120. 20)); 
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numEntriesStatic. setvi si ble (true) ; 
numEntriesStatic. setText("Number of Entries i 1 '); 
numEntriesStati c . setLocation(new lava. awt .Point (30, 190)); 

minstatic.setsize(new java. awt. Dimension(120 , 20)): 
nrinstatic.setvisible(true) ; 
minStatic.setText("Mim*mum; ") ; 

minstatic.souocation(new java. awt. Point(30, 220)); 

maximums tat ic . setsize(new java, awt. Dimcnsion(120, 20)); 
maximumstatic .setvisible(true) ; * 
maximumStatic.setTextC'Maximurn:") ; 

maximumStatic. setLocation(new java. awt . Point (30 , 250)); 

delayStatic. sctsizc(new java. awt .oimension(120, 20)); 
delayStatic. setvisible(true) ; 
delayStatic. setText("Delay(ms) : ") ; 

delayStatic, setLocation(new java . awt . Point (30 , 300)); 

fileNameLabel ,setSize(new java. awt .Dimension(lB0, 20)); 

fileNameLabel .setvisible(true) ; 

fi leNameLabel . setText ("None Selected") ; 

f i leNameLabel . settocati on(new java. awt . Poi nt (ISO , 150)); 

numEntriesLabel . setSi ze(new java. awt ,Dimension(180, 20)); 
numEntriesLabel , setvi sible(true) ; 
numEntriesLabel . setTextO'-") ; 

numEntriesLabel . setLocation(new java .awt . Point (150, 190)); 

mintabel . setSize(new java . awt .oimension(180. 20)); 
minLabel .setvi sible(true) ; 
minLabel . setText ("-") ; 

minLabel . setLocation(new java . awt . Point (150 , 220)); 

maxLabel , setsize(new java . awt . Dimension(180 , 20)); 
maxLabel .setvi sible(true) ; 
maxLabel . setText (" -") ; 

maxLabel , set Loc.it ion (new j*iva . awt . Point (150 , 250)); 

starteutton . setSi ze(new java .awt . Dimension(90 ( 30)); 
startButton. setvi si ble (true) ; 
startButton. setTextC'Start") ; 

startButton. settocation(new lava.awt ,Point(20, 380)); 

scopuutton ,sctsize(new java . awt . Dimension(90 , 30)); 
stopButton.setvisible(true) ; 
stopautton.setTextC'Stop") ; 

stopflutton.setLocation(new java. awt . Point(120, 380)); 

exi tButton.setSi ze(new java. awt ,Dimension(90, 30)); 
exitButton.setvisible(true) ; 
exi tButton. setText("Exit") ; 

cxi tButton . setLocation(new java. awt . Point(240, 380)); 

initButton.setSize(new java. awt . Dimension(110 , 30)); 

mi tButton, setvi si ble (true) ; 

i ni tout ton. se tTex t ("ini t i al i ze . . .") ; 

ini tnutton . sctLocat ion(new java. awt .Point(110, 20)); 

setSize(new j ava . awt . Dimension(353 , 451)); 
getContentPaneO . setLayout(null) ; 
setTitle("OMXPlayer") ; 
setLocation(ncw java .awt , Poi nt (0 , 0)); 
getContentPaneO . add(loadri I cdutton) ; 
getContentPaneO . add(f ileNamcStat i c) ; 
getContentPaneO . add(numEntriesStati c) ; 
getContentPaneO . add(minStati c) ; 
getContent Pane O . add (max l mums tat i c) ; 
getContentPaneO . add(delaystati c) ; 
getContentPaneO • add(fi leNameLabel) ; 
getContentPaneO .add(numEntriesLabel) ; 
getContentPaneO . add(mi nLabel) ; 
getContentPaneO .add(maxLabel) ; 
getContentPaneO . add(startButton) ; 
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getContentPaneO . add(. stopBut ton) ; 
getContentPaneO .add(exi tButton) ; 
g ct Con tent Pane () . adcH 1 m taut ton) ; 

1 o.kIf 1 U-nutto" . .uldAri iont i fierier (new j.iva . ,iwt .event . Ac t1 onL i s teocrO 
public void actionPcrformctl(]dVd.awi.cvcni.ActionEvcnt c) { 
loadn 1 etiutt onArt lonPorf orm«il(«) ; 

1 

i i.i rt nut ton addActioriLt stonrr (now java . awt . event .Act lonti stencrC.) { 
public void actionPerformedCjava. awt. event .ActionEvcnt e) { 
startButtonActTonPerformed(e) ; 

} 

stopButton.addActionLi stener(new java . awt . event .ACtlonListenerO { 
public void actionPerformedCjava. awt. event. ActionEvent e) { 

stopButtonActionPerf ormcd(e) ; • 

} 

cxitButton,addActionListener(new } ava. awt .event .Act ionListenerO ( 
public void actionPerformedCjava. awt .event .ActionEvent e) { 
exi tButtonActionPerformed(e) ; 

} 

lm uiutton. addAcoonLi stcner(ncw Java . awt . event .ACOonti StencrC) { 
public void actionPerformedCjava .awt .event .ActionEvent c) { 
i ni tButtonACtionPerformed(e) ; 

) 

addwi ndowLi stenerCnew java . awt . event .wi ndowAdapteK) { 

public void wi ndowcl os ing( java. awt .event .windowEvent e) { 
thiswindowClosmg(e) ; 

} 

)); 

END GENERATED CODE 

delaylnput . setsi ze(new j ava . awt . Dimens i on(90 , 30)); 
delayinput .setvisibleCtrue) ; . 
delaylnput . settocationCnew ] ava . awt . Poi nt U , IW) ) , 
fjetContentPane C) . add(delaylnput) ; 

) 

private boolean m shown - false; 

public void addNotifyC) 

super . addNoti f y () ; 

if (mShown) 
return ; 

// resize frame to account for menubar 
jMenuBar )MenuBar - geOMenuaar () ; 

Tf (iMenuBar !- null) { . *„u+. 

int iMenuBarHeight - iMenuBar . getPref e r redSi ze () . hei ght , 
Dimension dimension - getSizeC): 
dimension .height +* jMenuBarnei ght ; 
setSi ze(dimension) ; 

} 

mShown - true; 

} 

// Close the window when the close box is clicked 
void thi swi ndowClosingC java. awt. event. windowEvent e) 

sctvi sib": e(f al se) ; 
di sposeQ , 
System. exit(Q) ; 

} 

public void t xit2uttonActionF2rformedCjava.awt.cvent.ActionEvent e) 

{ 
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setvisible(false) , 
disposeC) ; 
System, exit(O) ; 



public void startButtonActionPerformedCjava . awt . event .ACtionEvent e) 

((DMXPlayerThread)playerThread) .delay « delaylnput .getvaluoQ ; 
C(DMXPlaycrThread)playerThrcad) . shouldRun ■* true; 
th, sctPri ori ty (th ,max_priority) ; 



public void stoptiuttonActi onl'crf ormed(java .awt . event . Acnont \7ent u) 

((DMXPlayerThread)playerThread) .shouldRun - false; 
th . se t Pn ori ty C th . min_priority) ; 



public void loadFileButtonActionPerformed(java.awt .event .ActionEvent e) 

Fileoialog d » new FileOialog(this, "Load data file", Fi leDialog . LOAD) ; 
d . showO ; 

String filename - d.getFileO; 
String di rName - d .getoi rectoryO ; 

if(fileName !- null) { 
try { 

f i leNametabel . setText(fi 1 eName) ; 
File f « new FileCdi rName , fileName); 
FileReader fr - new Fi leReader(f) ; 

int size - (int)f . lengthO ; 
char[) data - new char[size]; 
int chars^read - 0; 

whi leCchars^read < size) 

chars^read + ■» f r , read(data , chars„read , size - chars„read) ; 

f r . closeO ; 

String s - new Stri ng (data) ; 
StringTokenizer st ** new Stri ngTokeni zer(s) ; 

String t - new StringO; 
whi le(st .hasMoreTokensO) { 

t - st . nextToken() ; 

try { 

Double val - new Double(t); 
dataList .add(val) ; 
^ } catch (NumberFormatException nfe) {} 

} catch (iOException ioe) { 

JOptionPane errorDialog - new JOptionPaneC) ; 

erroroi alog. showMessageDi alogCnull , "Caught an lOCxception m LoadFi 1 eAct ionPerformcd . ") , 



dataCount - dataLi st . si ze() ; 

numEntriesLabel .setText(String.valueOf (dataCount)) ; 

if (dataCount > 0) { 

Double o - (Double)dataiist.get(O) ; 
dataMax » D; 
dataMin - d; 

for (int i - 1; i < dataCount; i++) { 
D - (Double)dataLi st.get(i) ; 

Double newMax - new Double(Math .max (dataMax .doublevalueO , d doublevalueC))) ; 
dataMax - newMax ; 

Double newMin - new Double (Math, rm n(dataMi n .doubl evalue() , o. doublevalueO)) ; 
dataMin - newMin; 

} 

} 
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maxLabel . setText(Stnng.valueOf (dataMax)) ; 
mintabel . setText (string . valueOf(dataMi n)) ; 

} 

playerThread - new dmxp! ayerThread(del aylnput . getValueO t dataList, dataMin, dataMax, DMX) 
th * new Thread(pl ayerThread) ; 
th.setPnon ty (th . min_priofuty) ; 
th.startC) ; 



public void t ni tout tonActi onPerformed (]ava . awt . event. ActionEvent e) 

f 

if (OMXUni verse , isAvai UbleO) { 

interNames - DMXUm verse . getlnterf aceNamesQ ; 

String reply - (Sr -i ng 1 ) 30pt"ionPane . shov/InputDi alog( . * 

thi s , 

"Select a dmx nterface;", 
"Select", 

JOpn onPane . QUE STlON_MES SAGE , 
null, 

interNames , 
-interNames [0] ) ; 

if (reply « null) return; 

selectedlnterface « -1; 

for (mt i =* 0; i < interNames . length; i ++) { 
if (reply ■» interNames[n] ) { 
selectedlnterface » i; 
break ; 

} 

} 

try { 

DMx.closeO ; 

dmx. selectlnterf aceFromlndex(selectedlnterface) ; 
dmx, setRGadyUiveO ; 

System. out . printlnC'Selecting interface number " + selectedlnterface); 

catch (DMXException x) { 

30ptionPane . showMessageDialogCthis , 
"dmx Error\n" + x. getMessageO » 
"□MX Error", 

DOptionPane . ERROR_MESSAGE) ; 
selectedlnterface « -1; 

) 

} else { 

30pt ion Pane . 5howMessageDialog(thn s , 
"Can't load dmx library!", 
"DMX error", 

JC?t TOflPane . CRHOR_MESSAGf!) ; 
selectedlnterface «= -1; 

} 

} 
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maxiabel . setText(String . valueOf (dataMax)) ; 
mini_abel . setText(S~ring. valueof (dataMin)) ; 

} 

playenhread « new DMXPlayerThread(delayInput .getvalueO , dataList, dataMin, dataMax, DMX) ; 
th - new Thread(playerThread) ; 
th, setPnori ty(th.MlN_pRiouiTY) ; 
th. startQ ; 



public void i ni tButtonAco onPerformed (jnva . awt .event . ActionEvcnt e) 
{ 

if (DMXUni verse . i sAvan lableO) { 

lruerNames » DMXUm verse .getlnterf aceNamesO ; 

String reply - (S* ~i ng"i ;)OptionPane . showlnputoi a1og( * 
thi s , 

"Select a dmx nterface:", 
"Select" » 

30ptioriPane .QU?-STION_MESSAGE, 
null, 

i nterNames , 

i nterNames [0] ) ; 

if (reply »» null) return; 
selectedmterf ace = -1; 

for (mt i = 0; l < interNames . length; i++) { 
if (reply « i nterNames [i ]) { 
sel ectedlnterf ace » i; 
break ; 

} 

} 

try { 

OMX.closeC) ; 

dmx .select Interface Fromindex (sel ectedlnterf ace) ; 
OMX.setReadytiveO ; 

System. out. pnntln("Selecting interface number " + selectedlnterf ace) ; 

} 

catch (OMXException x) { 

aoptionpane . showMessagem alog( thi s , 
"dmx Error\n" * x . getMessagc () , 
"omx error", 

JJOpti onPane . ERROR_MESSAGC) ; 
selectedlntcrface - -1; 

) 

) oU.. ( 

K)pt i on Pane . showMVssayeOl a log ( tin s , 
"Can't load dmx library!", 
"dmx Error", 

JC^tionPane . error_message) ; 
selectedlnterf ace = -1; 

3 

} 
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* ^PlayerThread, java 

■ cle: DMXPlay^r 
jthor: bchemel 

jescnption; This application reads data from a text file and writes it to a dmx channel.,. 



i mport lava . uti 1 . * ; 

import com. col orki net ics .control .dmx. ft ; 
import javax. swing.*; 
import java.awt.*; 



public class DMXPlayerThread implements Runnable { 
public int delay; 
public Double max; 
public Oouble min; 
public double oldval » 0.0; 
public double mean => 0.0, 
public LinkedList data; 
public boolean shouldRun - false; 

public DMXUni verse dmx; 
private Strinq[j interNames; 
private int sel ectedinterf ace =■= -1; 
private JFrame frame; 

private static final int IRDA_BAUD - 

private static final int sp_baud„S31 

private static final int SP_BAUD_S32 

private static final int S3l » 1; 

private static final int S J 2 - 2; 

private int irdaBaud - IRDA_BAUD; 
private int spBaud - SP_BAU0„SI1 2 ; 
private int i nterf aceval ue - SJ2; 

public OMXPlayerThread(int d, LinkedList 1, Double Min, oouble Max, DMXUniverse univ) { 
dmx - univ; 
delay « d; 
data - 1 ; 
max - Max ; 
mi n ■ Mi n ; 

i nt len - data . si zeC) ; 

for(int i * 0; i < len; i++) { 

mean +■ ( (Double)data . get (i)) . doubl eVal ue () / (double)len; 

} 

} 

public void run() { 
while(true) { 

whi le(shouldRun) { 

DMXPrame buffer * new DMXFrame (512) ; 



oouble 0 - (Oouble)data . removeFi rst C) ; 
System. out . pnntln("New value; + D) ; 
data.add(D) ; 

float span - (f loat)m,ix . doubl eVal ue () - ( f1oat)mi n . doubl eVal lie () ; 
// float hue - ((f loac)o, doub leValueO - (float)min, doublcva tue())/span; 

double d - o. doubl evalue() ; 

try { 

1or(int l « 0; i < delay; i+O ( 

double outval - oldval + (((double)i + 1 . 0)/(doublc)delay) * Cd - oldval); 
float hue - (float)O.O; 
if(outVal > mean) { 

hue - (float)Cl. 0/3-0) ; 
} else { 

hue » (floet)O-O; 

) 

float brightness * (float)O.OO + (Math . abs( (float) (outval - mean))/span) ; 



1; 

- L0; 
= 4; 
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c.olor t - new Oolm (toloi . HMHOk(,u0um* , (f lo,n)l 0. In i>|l!lm'V.)) . 

buf f er . setoata(0. c.yfiRfdO , 0), 
buffer, setoata(l, c.getGrcenO. 0); 
buffer. setData(2 t c.tjetBlue<), 0); 
OMX.sendFrame(buff er) ; 
buffer. resetPriorityO ; 
Thread. sleep(l) ; 

} 

} catch (Exception x) { * 
System. out . pri ntl n("Caught a omx error!"); 
System. out .print In (x) ; 



oldval - d; 
} catch (Exception e) {} 
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// Ir.cegerlnput .Java 

// 

// 
/ / 

// 
// 

import j avax . swi ng . * ; 

import j avax . swi ng . text * ; 

import java.awt.*; 

import 3 ava . awt . event . * ; 

* An input field for integers # 

* ©version 1.0 

* ^author Mike Blackwell 
V 

public class intcgerinput extends JTextrield { 
private mt minval, maxval ; 

* Create a new integer input field with an initial value of <code> i ni tval </code> , 

* and a column width of <code>co 1 umns </code> , Minimum and maximum values are 
" specified. 

V 

public Integerlnput (i nt imtval, int columns, int min, int max) ( 
super(columns) ; 
mmval -min; 
maxVal - max; 

setDocument (new mtegeroocument <)) ; 
if (i ni tval < mi n) { 

setvalue(mi n) ; 
} else if (initval > max) { 

setvalue(max) ; 
} else { 

setvalue(im tval) ; 

} 

} 



* Create a new integer input field with a min of 0 and a max of 

* Integer.MAX^VAtuc . 
V 

public Integerlnput (int initval, int columns) { 
this(imtval, columns, 0, integer .max_ value) ; 

) 



* Return the integer value contained in the field. 
V 

public int getValueC) { 
i nt val ; 
try { 

val - integer .parselnt(getText()) ; 

} 

catch (NumberFormatException e) { 
val » 0; 

} 

return val ; 

} 



/** 

* set the integer value of the field. 
V 

public void setvalue(int val) { 

se t Text (integer . toStri ng(val )) ; 

} 
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public int getMinvalueO { return minVal; } 

public int getMaxvalueO { return maxval ; } 

public void setMinvalue(int v) { minVal - v; J 

public void setMaxva1ue(int v ) { maxval - v; } 



class integcrDocument extends plainoocument { 

public void inscrtString(int offset* String s, AttributcSct attrs) 
throws BadiocatlonException { 

// Test build the resulting string first. Beep and don't 
// allow if it's not an integer, or if it's out of bounds, 
StringBuf fer t - new Stringouff er(getText(0 ( getLength())) ; 
t . inscrt(of f set , s) ; 
try { 

int v - integer. parselnt(t . toStringO) ; 
if ((v < mmval) It O > maxval)) 

throw new Exception("lnteger out of bounds"); 

catch (exception e) { 

Tool kit.ge toe f aul tiTool ki t() .bccpO ; 
return; 

} 

super. i nsertStringCof f set , s, attrs) ; 

) 
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" ^PlayerApp. java 

,-le: DMXPlayer 
^-jthor: bchemel 

ascription: This application reads data from a text file and writes it to a OMX channel. 



import DMXPlayerFrame; 
import javax. swing, * ; 

public class DMXPlayerApp 
{ 

public dmxp! ayerAppO 
try { 

// for native Look and Frel , uncommon t the following code. 
/* 

try { 

UIManager . se tLookAndreel (UIManacjer . go tSystcmLookAndFec lei assNameO ) ; 

} 

catch (Exception e) { 
} 

V 

OMXPlayerFrame frame - new owxPlayerrrameO , 
frame . i m* tComponents O . 
frame ,setVisible(Wuc) ; 

) 

catch (Exception e) { 

e.printStackTraceO ; 

} 

} 

// Main entry point 

static public void mai n(5tri ng [] args) 

{ 

new DMXPlayerAppO , 

) 

} 



